Skip to content

feat(core,hooks,mcp,cli): wake requests + attention inbox#29

Merged
NagyVikt merged 1 commit intomainfrom
agent/claude/wake-inbox
Apr 24, 2026
Merged

feat(core,hooks,mcp,cli): wake requests + attention inbox#29
NagyVikt merged 1 commit intomainfrom
agent/claude/wake-inbox

Conversation

@NagyVikt
Copy link
Copy Markdown
Collaborator

Summary

  • Add task_wake / task_ack_wake / task_cancel_wake MCP tools — a lightweight nudge primitive that complements handoffs. No claim transfer, no baton pass. Targets see the wake in the next SessionStart or UserPromptSubmit preface with a copy-paste ack call; sender sees the ack on their next turn.
  • Add attention_inbox MCP tool and colony inbox CLI that aggregate pending handoffs, pending wakes, stalled hivemind lanes, and recent other-session file claims into one compact progressive-disclosure view.
  • Mirrors the handoff lifecycle (pending → acknowledged | cancelled | expired) and stores structured wake metadata so the hook preface can render without decompressing content.

Scope

This is the "first patch" from the wake/takeover design discussion: wake request + attention inbox only. Explicitly deferred to follow-ups — safe session takeover, claim TTL renewal, SessionEnd checkpoint, terminal-control wake.

Test plan

  • pnpm typecheck
  • pnpm lint
  • pnpm test (new: wake-request.test.ts, attention-inbox.test.ts; extended: task-injection.test.ts, task-threads.test.ts, server.test.ts)
  • pnpm build
  • Smoke: colony inbox --session … --agent … --repo-root … against a running colony DB

🤖 Generated with Claude Code

Add a lightweight cross-agent "please attend" primitive and an inbox view:

- task_wake / task_ack_wake / task_cancel_wake MCP tools post a wake request
  on a task thread. No claim transfer, no baton pass. Targets see it in the
  SessionStart preface and in the turn-boundary activity block with a
  copy-paste ack call; sender sees the ack on their next turn.
- attention_inbox MCP tool plus `colony inbox` CLI command aggregate pending
  handoffs, pending wakes, stalled hivemind lanes, and recent other-session
  file claims into one compact progressive-disclosure view.

Mirrors the handoff lifecycle (pending -> acknowledged/cancelled/expired)
and reuses the same metadata / task-scoping shape so the two primitives
can coexist without a schema change.

Follow-ups deferred: takeover of stalled/dead sessions, claim-TTL renewal,
SessionEnd checkpoint, terminal-control wake.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@NagyVikt NagyVikt merged commit 754949f into main Apr 24, 2026
1 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant